Inside Macintosh: QuickTime /

Chapter 3 - Image Compression Manager / Image Compression Manager Reference

Image Compression Manager Functions / Changing Sequence-Decompression Parameters

SetDSequenceSrcRect

The SetDSequenceSrcRect function defines the portion of the image to decompress.

pascal OSErr SetDSequenceSrcRect (ImageSequence seqID, 
                                  const Rect *srcRect);

seqID

Contains the unique sequence identifier that was returned by the DecompressSequenceBegin function (described on page 3-107).

srcRect

Contains a pointer to a rectangle defining the portion of the image to decompress. This rectangle must lie within the boundary rectangle of the compressed image, which is defined by (0,0) and ((**desc).width,(**desc).height), where desc refers to the image description structure you supply to the DecompressSequenceBegin function. If the srcRect parameter is nil, the rectangle is set to the rectangle structure of the image description structure.

DESCRIPTION

The decompressor acts on that portion of the compressed image that lies within this rectangle. The new source rectangle takes effect with the next frame in the sequence.

RESULT CODES

noErr	0	No error
paramErr	-50	Invalid parameter specified

SEE ALSO

You set the default source rectangle for a sequence with the srcRect parameter to the DecompressSequenceBegin function.